home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 #1 / Ham Radio 2000.iso / ham2000 / packet / p_aa4re / bbrqth3c / bbrtqth.doc < prev    next >
Encoding:
Text File  |  1994-01-01  |  7.2 KB  |  159 lines
  1. ==============================================================================
  2. BBrtqth.exe                        (c) 1993-1994 by Freeman. M. Crosby W1NPR
  3. Used  with  the  AA4RE BBS V2.12C+ (c) 1989-1992 by H. Roy Engehausen  AA4RE
  4. ==============================================================================
  5. Requires BB2.12C or later, a FAST Hard drive & an installed SAM CallSign
  6. database, Wpages are optional but will provide added data.
  7. The W1NPR Zipcode index is also optional and may be created by BBsamzip.exe,
  8. obtained on disk or downloaded from the W1NPR LL Port.
  9. ============================================================================
  10.  
  11. Description:
  12.  
  13. A QTH server which will provide Users with the ability to obtain listings by
  14. name as well as callsign for hams, clubs, military & races.
  15. Optional Wpage & zipcode listings and all SAM Database options are available
  16. with complete old/new call conversion, License renewal date, First date
  17. licensed, County, Full Birthdate & more.
  18. =============================================================================
  19. Updating BBrtqth.exe from a previous version:
  20.  
  21. Update your SAM database and be SURE to use the NEW SAMAPI.EXE included.
  22. No other installation is required except to replace the BBreqqth.exe file
  23. with the updated version.
  24.  
  25. =============================================================================
  26. NOTE !!!!
  27. All the BBrtqth servers will now display the locally Edited data and added
  28. calls from your SAM program, to make this data effective you must re-load
  29. the SAMAPI tsr or re-boot your system after editing the database.
  30.  
  31. Be sure if you have the Previous call option you run REVPREV to create the
  32. reverse call option database, this will allow users to enter either the
  33. new or old call to get the data on a listing. The other call will appear
  34. in the reply.
  35. =============================================================================
  36.  
  37. Installation & Setup:
  38.  
  39. Place the BBrtqth.exe program file anywhere you wish, place BBrtqth.trl,
  40. BBrtqth.rep & any zipcode indexes in the same directory as your SAM database
  41. If you select any directory other than the "BB" default for BBrtqth.exe
  42. you must path to it when calling it up.
  43.  
  44. Edit the BBrtqth.trl & BBrtqth.rep files to suit
  45. ( Note Trailer not recommended but you may use it if desired )
  46.  
  47. Edit BBrtyp.cfg as follows:
  48.  
  49. Copy BBrtqth.rep into your help.bb file and prefix it with this line:
  50.  
  51. : QTH N
  52.  
  53. =========================== Sample BBrtyp.cfg ==============================
  54. C:\SAM\
  55. C:\bb\wp\
  56. S
  57.  
  58. NOTE! This configuration file must be EXACT ! for proper operation of your
  59. BBREQQTH server. These text lines should be left in for future reference.
  60.  
  61. Each parameter is on a single line.
  62. Line #1 = Exact path to your SAM callbook database, in which you should have
  63.           all related files, trailers etc.
  64. Line #2 = Exact path to your Wpages database if you have it set up. If not
  65.           just put NO
  66. Line #3 = The type of Wpage system you are running , there is no default it
  67.           must be L or S or NO ! IF you do not have a Wpage system setup then
  68.           just put NO.
  69.           Do NOT leave it BLANK.
  70.  
  71. The server reads from top to bottom and picks up the configuration.
  72. Do NOT have any comments etc. Just facts in these lines left justified etc.
  73. It will work if you have it right. This simple configuration saves code in
  74. the main program.
  75.  
  76. ======================= End of sample BBrtqth.cfg ===========================
  77. Action.bb:
  78.  
  79. Place the following line exactly in Action.bb and then an "A" command to load it.
  80.  
  81. DEFINE_USER_COMMAND QTH ES [aos] QTH BBRTQTH.EXE @$y *$1
  82.  
  83. If BBrtqth.exe is not in the "BB" defaut directory then path it as follows.
  84.  
  85. DEFINE_USER_COMMAND QTH ES [aos] QTH Path/BBRTQTH.EXE @$y *$1
  86.  
  87. See AA4RE's Server.doc & Action.doc for explainations or other options.
  88. ==============================================================================
  89. SYSOP & USER Commands for the Real time QTH server:
  90.  
  91. Command                       Reply
  92. =============================================================================
  93. CB Callsign  (REBBS Command)  Returns Callsign QTH From SAM Callbook database
  94. QTH Callsign                  Returns Callsign/Wpage & added data if available
  95. QTH FIND First M Lastname     Will do a name search using what information
  96. QTH VEFIND ""   Canadians     you provide. Lastname must be EXACT, First is
  97. QTH RFIND  ""   Races         left progressive, M is not needed but will help
  98. QTH MFIND  ""   Military      in narrowing down the search. A list will be
  99. QTH CFIND  ""   Clubs         provided which you may select from to narrow
  100.  
  101. QTH MORE First M Lastname     Same as above but will start at point designated
  102. QTH VEMORE "" for Canadians   and continue until Lastname ends or file too big
  103.  
  104. First and Lastname may have spaces added as in MC_PHERSON by using the "_"
  105.  
  106. QTH I                         Information about the server
  107. QTH ?                         Returns this text file edited by sysop
  108. QTH ZIP #####                 Returns all calls in the USA Zipcode requested
  109.                               & must include 5 numbers
  110. ==============================================================================
  111. Special searches as in Clubs etc. Use only Lastname as in ARRL_HEADQUARTERS
  112. In a name search if the reply reaches 5000 bytes you will be instructed with
  113. the exact command to proceed.
  114. Examples are FIND W Smith ( All Smith with a first name starting with W and any
  115. middle initial)
  116. Narrow down to FIND William Smith, then possibly FIND William R Smith or
  117. whatever after you get some responses.
  118. The MORE Command will allow you to obtain all the Lastnames and will prompt
  119. you on the next request you should make from either the FIND or MORE command
  120.  
  121. Canadian & special search NOTE ! use VEFIND, VEMORE etc. exactly, no spaces !
  122.  ============================================================================
  123. This program was written using all the SAM update options, if not all are
  124. installed it should detect and function with whatever is available. This
  125. has not been tested. If the options are not used, previous BBrtqth servers
  126. will function as before.
  127.  
  128.  
  129.  
  130.  
  131. First VERSION of an update ( BETA TEST ) !!
  132. This program was developed while writing several others and has not been
  133. well tested. It uses modules from several other programs each of which work
  134. but may cause unforeseen conflicts when combined together.
  135. As the BBS will stop while the server runs two limits are placed on the
  136. reply time, one is that the server will only supply about 5k of data to the
  137. user per request, second is it will stop after 30 seconds no matter what it
  138. has found and prompt the user for another request.
  139. I am sure this will cause conficts with busy systems with many users connected
  140. and much forwarding. It may not be possible to use this server in all cases &
  141. we hope further developments will allow full multitasking.
  142.  
  143. ALSO read Disclaim.er  !
  144.  
  145. ==============================================================================
  146. Report bugs & comments to:
  147.  
  148. Oct. 1 to June 1 yearly
  149. W1NPR@W1NPR.#SRQFL.FL.USA.NA
  150. (813)474-2690     Voice line
  151. (813)475-9526     Data  line
  152.  
  153. June 1 to Oct. 1 yearly
  154. W1NPR@W1NPR.#EMA.MA.USA.NA
  155. (508)362-3940     Voice line
  156. (508)362-8958     Data  line
  157.  
  158. 73/Free
  159. W1NPR